home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / mvpforth.arc / MVPFRTH.DOC < prev    next >
Text File  |  1986-04-20  |  8KB  |  218 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         MVPFORTH.DOC    15 Oct 1983     R. S. White     Marion,IA.
  8.  
  9.         This is a FORTH-79 implementation of the FORTH language
  10. done by Glen B. Haydon with most of the old fig-FORTH words also
  11. defined.  It has been very generously placed in the public domain
  12. by Mr. Haydon in the spirit of the original FORTH INTEREST GROUP's
  13. 1978 dissemination of working versions of the language.
  14.  
  15.         The purpose of this short piece of documentation is to
  16. steer users to the appropiate references on this language
  17. implementation and to make some quick notes about my intial
  18. experences with MVP-FORTH version 1.0305.02.
  19.  
  20.  
  21. 1. References & Tutorials
  22.  
  23.         A. ALL ABOUT FORTH
  24.            An Annotated Glossary
  25.            
  26.            by Glen B. Haydon
  27.  
  28.            Second Edition
  29.  
  30.            Mountain View Press, Inc.
  31.            P.O. Box 4656
  32.            Mountain View, CA 94040
  33.            (415)961-4103
  34.  
  35.            Order direct from the publisher for approx $25.
  36.            They will take phone in orders and charge to
  37.            M.C., VISA or COD for approx $5 extra.
  38.  
  39.            This is the definitive glossary and definition of
  40.            MVP-FORTH with references to any differences between
  41.            it and FORTH-79, fig-FORTH and the FORTH described
  42.            in STARTING FORTH.  The FORTH-79 STANDARD and FORTH-79
  43.            HANDY REFERENCE is included in this book.  It is not
  44.            a tutorial!
  45.  
  46.  
  47.         B. STARTING FORTH
  48.  
  49.            An Introduction to the FORTH
  50.            Language and Operating System
  51.            for Beginners and Professionals
  52.  
  53.            by Leo Brodie,  FORTH, Inc.
  54.  
  55.            Prentice-Hall, Inc.
  56.            Englewood Cliffs, NJ 07632
  57.  
  58.            Availible at most bookstores, ie DALTON's
  59.            for approx $15.95.
  60.  
  61.            This is an outstanding tutorial book that
  62.            even people who never have any intention to
  63.            learn FORTH give good reviews. (and read through)
  64.            Better yet it appears that Glen Haydon took pains
  65.            to make his implementation of FORTH capable of
  66.            operating like the FORTH described in BRODIE's
  67.            book whenever possible.  In particular, the line
  68.            editor included in the MVPFORTH.COM binary image
  69.            complies with the EDITOR described in STARTING
  70.            FORTH.  The exceptions to STARTING FORTH are
  71.            pointed out by ALL ABOUT FORTH.  These differences
  72.            mainly occur when one is messing around with
  73.            ticking name field addresses ( NFA )'s and stuff
  74.            which is not normal FORTH application programming
  75.            practice and is discouraged by the FORTH-79 STANDARD.
  76.  
  77.                 It is possible to do a lot with MVP-FORTH
  78.            and just use STARTING FORTH without buying ALL 
  79.            ABOUT FORTH until one feels comfortable with the
  80.            language and wants to get down to the nitty-gritty
  81.            details and write/include decompliers, MSDOS screen
  82.            files, etc.
  83.  
  84.  
  85.         C. FORTH DIMENSIONS, Vol III  No. 3
  86.  
  87.                 Availible from the FORTH Interest Group
  88.            P.O. Box 1105,  San Carlos, CA 94070 by purchasing
  89.            all 6 backissues of Vol III for $15 postpaid.
  90.  
  91.                 This issue has an article which provided the
  92.            EDITOR that Glen Haydon implemented in MVP-FORTH.
  93.  
  94.            
  95.  
  96. 2. other FORTH information sources of note ( not inclusive )
  97.  
  98.         A. Join FIG  ( FORTH Interest Group ) and get current
  99.            issues of FORTH DIMENSIONS.  This bimonthly magazine
  100.            follows the further refinement of the FORTH language
  101.            standards, has many useful articles about programming
  102.            techniques/tools and seems to be a lively forum about
  103.            FORTH issues in general.  Dues are $15 a year. 
  104.  
  105.         B. August 1980 issue of BYTE magazine.  This FORTH theme
  106.            issue served as the inspiration for many of us FORTH
  107.            latecomers.
  108.  
  109.         C. Dr. Dobb's Journal. Especially the annual FORTH issues
  110.            every September.
  111.  
  112.  
  113. 3. Startup experiences
  114.  
  115.         I downloaded MVPFORTH.ASM and MVPFORTH.COM (as MVPCOMND.COM)
  116. using an XMODEM protocol from Gene Plantz's RBBS Chicago bulletin
  117. board.  My display flipped to 40 column colored text mode when I invoked
  118. the binary file ( it was in 80 col b&w mode ).  However normal simple
  119. FORTH commands and math seemed to work fine.  I discovered a control-P,
  120. not a control-prtsc toggled the printer echo on and off.  Just like the
  121. CP/M-80 versions of FORTH I have used.  
  122.  
  123.         The next step was to do a VLIST with the printer echo on and
  124. see what I got.  Hooray!  An EDITOR, a 8088 ASSEMBLER, double number
  125. extensions, fig-FORTH and FORTH-79 equivalences, and the normal misc
  126. extensions like TRIAD, INDEX, etc.  The VOCABULARY worked like the
  127. FORTH-79 STANDARD with only the EDITOR or the ASSEMBLER being present
  128. when invoked in addition to the FORTH vocabulary.
  129.  
  130.         A quick glance at the EDITOR words led me to think it worked
  131. like the fig line editor.  I put a couple of new formated disks in
  132. my drives:
  133.  
  134.                 20 LIST                 got a bunch of + signs.  OK
  135.  
  136.                 20 CLEAR 20 LIST        nice 16 * 64 numbered blank screen
  137.  
  138.                 L                       unknown. LIST did not invoke
  139.                                         the EDITOR vocabulary automatically
  140.  
  141.                 EDITOR L                worked.  got an EDITOR screen display
  142.  
  143.                 0 P line 0              seemed to work
  144.  
  145.                 1 P line 1
  146.  
  147.                 L                       the second " line 1 " was displayed
  148.                                         on the first line. not working
  149.  
  150.                 EMPTY-BUFFERS           giving up. I put the original DOS
  151.                                         disk with MVPFORTH.COM back in drive A
  152.  
  153.                 BYE                     returned to MSDOS OK
  154.  
  155. I thought I could not do anything till I got ALL ABOUT FORTH in the mail
  156. from Mountain View Press.  The EDITOR seemed to be a line editor like the
  157. fig version I was familar with, but at first glance seemed to be broken.
  158.  
  159.         The MVPFORTH.ASM kernal source was assembled error free at work
  160. using the Microsoft MASM assembler.  It has very few comments but at least
  161. I had a good cross-referenced assembler output listing to figure out the
  162. actions of the FORTH words.
  163.  
  164.         Then I had a recollection about a different kind of FORTH line
  165. editor described in STARTING FORTH.  Those commands work!  Now I thought
  166. it worthwhile to pour over the assembly source and figure out what was
  167. flipping my USI Multidisplay video adapter to 40 columns.  The PAGE
  168. command vectored to <PAGE> which did an INT 10H bios rom video call with
  169. 0 in the AL register and 0 in the AH register.  That will do it.  I had
  170. to do that INT call with 2 in the AL register.  Here is the code that
  171. will fix the 40 column problem for those of you who use cheaper 15.75 kHz
  172. composite B&W monitors or expensive RGB monitors with the color graphics
  173. adapter:
  174.                 DECIMAL
  175.  
  176.                 : <PAGEW>  2 0 0 0 16 INTCALL DROP ;
  177.  
  178.                 FIND <PAGEW> 'PAGE !    ( save new code version in PAGE
  179.                                           vector )
  180.  
  181.                 FREEZE                  ( now can't FORGET what was just
  182.                                           done )
  183.  
  184.                 SAVE-FORTH              ( saves memory image of MVPFORTH
  185.                                           on MSDOS disk A: as COMMAND.COM )
  186.  
  187.  
  188.  
  189. and here is a quickie that will blank all 160 blocks on a 5.25"
  190. single-sided disk (8 sectors per track) which is what MVPFORTH
  191. defaults to:
  192.  
  193.                 DECIMAL
  194.                 : IDISK  160 0 DO I CLEAR LOOP ;
  195.  
  196. The CONFIGURE word will let you declare your drives to be double-sided
  197. and give you blocks 0 to 359 availible instead of 0 to 159.  Try it,
  198. its menu driven.
  199.  
  200.  
  201.  
  202.         Naturally after doing the above I finally got my hands on a 
  203. borrowed copy of ALL ABOUT FORTH and verified that what I had just done
  204. was ok.  That's like reading the instructions after putting the child's
  205. bike together.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.